home *** CD-ROM | disk | FTP | other *** search
/ Aminet 41 / Aminet 41 (2001)(Schatztruhe)[!][Feb 2001].iso / Aminet / util / arc / xadmaster060.lha / xad / Docs / xadUnTar.doc < prev    next >
Text File  |  2000-12-03  |  3KB  |  93 lines
  1. NAME
  2.     xadUnTar 1.0
  3.  
  4. SYNOPSIS
  5.     xadUnTar FROM/A,DEST=DESTDIR,PASSWORD/K,FILE/M,NAMESIZE/K/N,
  6.     FFS=OFS/S,SFS/S,INFO=LIST/S,Q=QUIET/S,AM=ASKMAKEDIR/S,
  7.     OW=OVERWRITE/S,NA=NOABS/S,ND=NODATE/S,NE=NOEXTERN/S,
  8.     NKP=NOKILLPART/S,NP=NOPROT/S,NT=NOTREE/S
  9.  
  10. DESCRIPTION
  11.     xadUnTar is a shell tool to extract data from Tar archives and
  12.     compressed Tar archives. This includes .tar.bz, .tar.bz2,
  13.     .tar.gz, .tar.Z, .tar and others.
  14.  
  15.     FROM specifies the file archive that should be handled.
  16.     DESTDIR is the destination directory. The directory is created
  17.     when it does not exist (except if ASKMAKEDIR is turned on and
  18.     you select no). There are some dangerous archives using absolute
  19.     path names (e.g. starting with LIBS: or RAM:). xadUnTar archives
  20.     these files to their absolute position (except NOTREE or NOABS is
  21.     used).
  22.  
  23.     PASSWORD can be used to supply a password for unarchiving of
  24.     encrypted archives. This argument requires the keyword PASSWORD.
  25.  
  26.     FILE allows you to select filename(s) (including patterns), which
  27.     should be extracted. When FILE is not given, all files are
  28.     extracted. With FILE only matching files are extracted.
  29.     NOTE: When you do not use NOTREE keyword, the patterns check
  30.     includes checks for directory structure as well.
  31.  
  32.     NAMESIZE allows to specify the maximum size of a filename. This is
  33.     useful as some archives from unix machines have longer filenames
  34.     than the Amiga filesystem allows. Whenever a name is longer than
  35.     the namesize value, you are asked to enter a shorter name. Names
  36.     of directories are truncated without requests.
  37.     FFS or OFS replace NAMESIZE argument and provide a standard length
  38.     of 30 characters, which is the value of our standard file system.
  39.     SFS provide a length of 100 characters, the SmartFilesystem
  40.     standard.
  41.  
  42.     NOEXTERN prohibits the use of external clients for
  43.     recognition purposes.
  44.     
  45.     INFO or LIST prints information about the archive and does not
  46.     do any unarchiving.
  47.     
  48.     OVERWRITE forces the program to overwrite an already existing
  49.     destination file. Normally you are asked about that.
  50.     
  51.     NOTREE skips all directory names and writes the files directly to
  52.     destination directory.
  53.     
  54.     ASKMAKEDIR forces the program to ask you, if a missing directory
  55.     should be created.
  56.  
  57.     NOPROT prevents setting file protection bits and NODATE prevents
  58.     setting date information.
  59.  
  60.     NOABS prevents creation of absolute path names.
  61.  
  62.     If you specify NOKILLPART keyword, partial or corrupt output files
  63.     no longer are deleted.
  64.  
  65.     The QUIET option turns off the progress report, but also disables
  66.     questions to skip, rename or overwrite files.
  67.  
  68. EXAMPLES
  69.     Shell> xadUnTar archive.tar RAM:
  70.         Unarchive the tar archive to RAM:
  71.  
  72.     Shell> xadUnTar archive.tar.gz RAM: #?.txt #?.doc Contents
  73.         Unarchive all .txt and .doc file and the file "Contents" of
  74.         gzipped tar archive to RAM:
  75.  
  76.     Shell> xadUnTar archive.tar.bz LIST
  77.         Tells information about archive.tar.bz file.
  78.  
  79. HISTORY
  80.     xadUnTar 1.0
  81.     - First public release.
  82.  
  83. COPYRIGHT
  84.     xadUnTar is freely distributable for noncommercial use.
  85.  
  86. AUTHOR
  87.     Dirk Stöcker
  88.     Geschwister-Scholl-Straße 10
  89.     01877 Bischofswerda
  90.     GERMANY
  91.     
  92.     Dirk Stoecker <stoecker@amigaworld.com>
  93.